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ABSTRACT 


This  report  describes  the  use  of  a  computer  program 
called  IPLOT  for  interactively  generating  X-Y  plots  of 
digital  data.  The  program  is  built  around  the  widely- 
avallable  DISSPLA  plotting  software  in  order  to  be  as 
portable  as  possible.  IPLOT  has  command  and  input  file 
structures  similar  to  those  of  the  lUDS  program  used  at 
DTNSRDC,  except  that  IPLOT  can  label  axes  and  generate 
logarithmic  plots.  A  checkpoint/restart  capability  is 
Included. 


ADMINISTRATIVE  INFORMATION 

This  work  was  sponsored  by  the  Foundation  Acoustic  Design  Program,  Task 
Area  S1255001,  Element  63569N,  DTNSRDC  Work  Unit  1211-701.  The  Naval  Sea 
Systems  Command  program  manager  was  Richard  Chiu  (NAVSEA  55Y3). 


INTRODUCTION 

For  many  engineering  analyses  performed  on  a  computer,  there  Is  a  need 
to  make  X-Y  plots  quickly  in  an  interactive  mode  where  the  analyst  can  easily 
select  the  curves  to  be  plotted  together,  the  scaling,  the  window  size,  the 
line  styles,  and  the  labeling.  Some  of  this  need  has  been  satisfied  for  many 
years  at  DTNSRDC  with  the  IDDS  program^  written  by  Melvin  Haas  and  others  of 
the  Numerical  Mechanics  Division  of  DTNSRDC.  However,  the  mainframe  version 
of  IDDS  is  machine-dependent  and  may  not  be  converted  for  use  on  the  new 
Cray/Sperry  computer  system  to  be  Installed  in  a  few  months  at  DTNSRDC. 
(Development  is  continuing  on  the  Apollo  version  of  IDDS  called  AIDDS.  Since 
AIDDS  is  written  in  the  C  language  for  a  UNIX  system,  it  may  eventually  be 
available  on  the  new  Sperry/Cray  system.)  In  addition,  IDDS  is  unable  to 
label  axes  or  to  make  logarithmic  plots,  both  of  which  capabilities  are 
useful  for  the  display  of  results  generated  by  the  acoustic  radiation  program 
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NASHUA.  As  a  result,  a  new  Interactive  plotting  program  (IPLOT)  was  written 
as  a  general  replacement  for  the  X-Y  plotting  capabilities  In  IDDS.  (The 
other  capabilities  In  IDDS  are  not  being  addressed.) 

IPLOT  was  built  around  and  designed  to  run  on  any  computer  which  has 
access  to  the  Display  Integrated  Software  System  and  Plotting  Language 
(DISSPLA),^  versions  of  which  are  available  at  many  computer  centers.  To 
date,  IPLOT  has  been  run  on  both  the  CDC  Cyber  176  and  DEC  VAX  11/780 
computers  at  DTNSRDC.  IPLOT  Is  written  In  Fortran  77  and,  as  Is,  Interfaces 
with  a  Fortran  4  version  of  DISSPLA^  (which  DTNSRDC  has).  The  conversion  of 
IPLOT  to  Interface  with  a  Fortran  77  version  of  DISSPLA  would  require  changing 
a  few  of  the  calls  to  DISSPLA  routines,  since  Hollerith,  rather  than 
character,  variables  must  be  passed  to  a  Fortran  4  version  of  DISSPLA. 

However,  all  necessary  character  variables  exist  In  IPLOT  to  ease  the 
conversion  to  a  Fortran  77  version  of  DISSPLA. 

IPLOT  can  Interface  with  all  the  Tektronix  and  DEC  terminals  In  common 
use  at  DTNSRDC.  Other  terminals  could  easily  be  added  to  the  program,  since 
DISSPLA  supports  a  wide  variety  of  terminals.  IPLOT  has  the  capabilities  to 
make  plots  with  logarithmic  as  well  as  linear  axes  and  to  label  the  axes. 

IPLOT  uses  an  Input  file  structure  and  a  command  structure  similar  to 
those  used  In  IDDS.  Thus,  many  formatted  data  files  In  use  with  IDDS  can  be 
converted  for  use  with  IPLOT  with  a  single  command  of  an  editor. 

IPLOT  also  has  a  checkpoint /restart  capability  so  that  the  plotting 
parameters  (device,  scaling,  labeling,  etc.)  specified  In  one  session  can  be 
retrieved  for  use  In  a  subsequent  session.  The  local  file  name  IPLOTXX  Is 
used  for  both  the  checkpoint  file  and  the  restart  file. 


IPLOT  PROGRAM  USAGE 


INPUT  DATA  FILE 

The  file  containing  the  X-Y  pairs  must  be  a  formatted  file  with  each 
curve  defined  In  the  following  way: 

Record  1:  A  10-character  left-adjusted  "short  name"  for  the  curve. 

This  name  Is  used  for  Identifying  the  curve  during  the 
Interactive  plotting  session. 

Record  2:  An  80-character  left-adjusted  "long  name"  for  the  curve 

Record  3:  N  (the  number  of  X-Y  pairs  in  the  curve)  (integer) 

Records  A, 5,  ...  :  Xj,  Yj,  X2,  Y2,  X3,  Y3,  ...  ,Xjj,  Yj^  (real) 

The  above  set  of  records  Is  repeated  for  each  curve  placed  on  the  file.  Each 
record  is  an  80-character  "card  image."  All  numeric  data  are  read  using 
free-fleld  formats,  so  that  the  X-Y  pairs  may  be  written  using  any  real 
format  on  any  number  of  card  Images.  There  are  no  restrictions  on  the  number 
of  curves  contained  on  a  file.  If  a  logarithmic  plot  is  desired,  the  actual 
values  of  the  data  rather  than  the  logarithms  of  the  data  are  supplied  on 
this  Input  file. 

THE  INTERACTIVE  SESSION 

At  DTNSRDC,  the  executable  form  of  IPLOT  is  stored  on  the  mass  store 
file  IPLOT  under  the  user  name  CAEE.  Before  executing  this  program 
interactively,  the  user  must  attach  the  data  flle(s)  containing  the  X-Y 
pairs.  Multiple  files  are  allowed.  In  general,  any  combination  of  curves 
from  any  number  of  files  can  be  plotted  on  the  same  graph.  The  axes  may  be 
either  linear  or  logarithmic,  and  axes  may  be  numbered  and  labeled.  The 
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window  size  (the  size  of  the  box  containing  the  graph)  may  be  adjusted  to 
facilitate  overlaying  other  plots. 


To  continue  a  previous  plotting  session,  the  restart  file  must  be 
attached  and  given  the  local  file  name  IPLUTXX.  At  the  beginning  of 
execution,  IPLOT  checks  for  the  existence  of  IPLOTXX.  If  the  file  exists, 
IPLOT  retrieves  the  plotting  parameters  so  that  the  user  is  ready  to  continue 
his  previous  session  where  he  left  off.  As  the  new  session  proceeds,  IPLOTXX 
is  replaced  whenever  a  plot  Is  made  or  the  session  Is  ended. 


IPLOT  COMMANDS 

IPLOT  uses  a  free-fleld  Input  format  with  the  various  data  fields 
separated  by  commas,  which  are  required.  Blanks  may  be  placed  before  or 
after  the  commas  to  Improve  readability.  In  general,  a  parameter  which  Is 
omitted  remains  unchanged  from  that  set  previously.  The  allowable  commands 
are  summarized  as  follows: 


C, FILENAME 


E 

H 

I 


-  List  contents  of  file  FILENAME.  For  each 
curve  on  the  file,  this  listing  includes  the 
short  name,  the  number  of  X-Y  pairs,  the 
maximum  and  minimum  ordinate  values,  and  the 
long  name. 

-  Exit  from  program. 

-  Help  (l.e.,  print  summary  of  commands). 

-  Toggle  to  use  or  not  use  integer  labels  on 
linear  axes. 


L,NX,NY  -  Use  logarithmic  axis,  where  NX  and  NY  are 

the  number  of  cycles  along  x  and  y, 
respectively  (integer).  (A  zero  value  is 
used  to  specify  a  linear  axis.)  Entering  L 
with  no  parameters  Is  equivalent  to  L,0,0. 


P,FNi,SNi,LSi,FN2,SN2,LS2,. 


Toggle  to  mark  or  not  mark  the  ends  of  the 
curves  with  numerical  symbols. 

Plot  some  curves,  where  FN  »  filename, 

SN  “  short  name  of  curve,  LS  =  line  style 
desir  :d  (1-9).  To  plot  the  points  with 
symbols  not  connected  by  a  line,  enter 
LS  *  0.  IPLOT  selects  the  symbols.  If 
several  curves  have  been  plotted,  the  first 
few  can  subsequently  be  plotted  by  entering 
P  followed  by  a  number  of  commas  equal  to 
three  times  the  number  of  curves  desired 


-  Quit  (same  as  Exit). 

-  Repeat  last  plot  command. 


S , XMIN , DX , XMAX , YMI N , DY , YMAX 


Scale  a  plot  using  the  specified  minimum. 
Incremental  step,  and  maximum  values  of  X 
and  Y.  This  command  is  required,  since 
there  is  no  default  scaling.  For  a 
logarithmic  axis,  for  which  the  number  of 
cycles  is  specified,  only  the  minimum  value 
is  used.  For  integer  values,  the  decimal 
points  may  be  omitted  on  CDC  (but  not  on 
VAX). 


T,<8trlng> 


-  Specify  the  title  of  the  plot. 

-  Verify  (i.e.,  display)  the  current  values  of 
the  user-selected  parameters. 


W,RX,RY 


X, <string> 

Y, <string> 


-  Change  the  current  window  size  by  the  factors 
RX  and  RY  In  the  X  and  Y  directions, 
respectively.  To  restore  the  default  window 
size,  enter  W  with  no  parameters. 

-  Specify  the  x-axls  label. 

-  Specify  the  y-axls  label. 


All  the  above  commands  except  the  plot  command  (P)  have  as  their  only 
effect  the  setting  of  one  or  more  parameters  or  the  display  of  some 
information.  When  the  plot  command  is  Issued,  the  current  values  of  all 
parameters  and  labels  (which  can  be  displayed  with  the  V  command)  are  used 


'TV;!, 


»  e  «», 


»  »■  » 


for  the  plot.  In  general,  the  commands  may  be  entered  in  any  order,  except 
that  S  (scale)  must  precede  P  (plot),  since  there  is  no  default  scaling  in 
IPLOT. 

After  each  plot  is  made,  the  program  pauses  to  allow  the  user  to  make  a 
copy  of  the  plot.  To  return  to  the  "command  mode,”  the  CDC  user  enters  a 
space  followed  by  the  carriage  return;  the  VAX  user  need  only  press  the 
carriage  return. 

Sample  plots  (both  linear  and  logarithmic)  are  shown  in  Figs.  1  and  2 
for  illustration.  The  second  figure  also  uses  the  curve  marking  option.  A1 
plots  were  made  from  the  same  data. 
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IMPEDANCE  (DB) 


EXAMPLE  WITH  LINEAR  AXES 
-  SHORTNAMEl  LONG  NAME  1  GOES  HERE 


SH0RTNAME2  LONG  NAME  2  GOES  HERE 


FREQUENCY  (HZ) 


tig.  1.  Sample  plot  with  linear  axes > 
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IMPEDANCE  IDB) 


EXAMPLE  WITH  LOGARITHMIC  X-AXIS 

->  SHORTNRMEl  LONG  NAME  1  GOES  HERE 
-a  SH0RTNRME2  LONG  NAME  2  GOES  HERE 
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